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© Shell document with variable document commands. 



© An improved technique for inserting variable text 
or images into shell documents (150) to produce 
complex reports and form letters. This technique 
greatly simplifies the control structure used to insert 
the variable data and makes the maintenance and 
updating of shell documents much easier. To ac- 
complish this, shell documents have common text 
(20, 24) and at least one variabie document com- 
mand (152). Variable document commands are per- 
mitted to have variable fields (154, 156, 158). In this 
way, variable text or images may be inserted based 
upon reference to variables stored in variable fields 
without the need to use conditional instructions in 
the shell document. 
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SHELL DOCUMENT WITH VARIABLE DOCUMENT COMMANDS 



The subject invention relates generally to word 
processing systems, and more particularly, relates 
to word processing systems for preparation of a 
number of personalized copies of form documents. 

The use of computer and data processing 
equipment directed to word processing applications 
is well known in the art. Such systems provide the 
capability to merge text with data to create com- 
plex reports and mass mailings. Millions of letters, 
for example, are mailed every day which use a 
form or shell letter combined with inserted data 
(e.g., name and address). 

U.S. Patent No. 4,085,445, teaches a word pro- 
cessing system, which interleaves the printing of 
letters and envelopes to simplify and speed up 
mass mailings. In the preferred mode, the data to 
be inserted is name and address information. 

Merging of other data is shown in U.S. Patent 
No. 4.454,576. However, this reference is primarily 
directed to a technique for reducing report genera- 
tion commands to machine dependent language for 
transliteration between various operator languages. 

The IBM 5520 Administrative System is well 
known as a current system having a powerful capa- 
bility to create mass mailings and very complex 
reports. To perform these applications, a document 
called a Merge Control Document (MCD) is used 
combined with data from a text file. The MCD will 
commonly also be called "shell document" herein. 

Creation of an MCD or shell document is dis- 
closed in IBM Technical Disclosure Bulletin, Vol- 
ume 28, Number 12, pages 5642-5643, dated May, 
1986, and entitled "Method to Merge Table Data 
Using One-Cell Table Objects". This technique is 
useful for generating form letters with specific vari- 
able data inserted. 

The generation of complex documents of the 
type described herein is discussed in IBM Tech- 
nical Disclosure Bulletins: 

1) Volume 29, Number 1, pages 406-407, 
dated June, 1986. entitled "Improved Technique for 
Printing Multi-Copy Documents"; 

2) Volume 29, Number 6, pages 2387-2389, 
dated November. 1986, entitled "Word Processor 
Having Conditional Text Printing for Mass Mail- 
ings"; and, 

3) Volume 30, Number 5, pages 184-188. 
dated October, 1987, entitled "Enhanced Tech- 
nique for Merging Data from a Second Document". 

Each of these teach the use of the IBM 
DisplayWrite__ Text Instructions to generate such 
documents. However, these techniques require 
substantial complexity in the drafting, maintenance 
and modification of the MCD or shell document. 

The present invention provides a much simpler 



technique for creating documents that can be used 
in combination with data to create complex reports 
and mass mailings. The person creating these doc- 
uments does not need to understand the concepts 

5 of or be able to use a pseudo-programming lan- 
guage. Maintenance and enhancement of the ap- 
plications can be easily accomplished without fear 
of ruining the entire application. 

To create such documents, the operator de- 

70 fines a shell document. A shell document has com- 
mon text and at least one document command. 
Document commands can be either fixed docu- 
ment commands or variable document commands. 
Fixed document commands are known in the prior 

75 art. The present invention teaches variable docu- 
ment commands. Each variable document com- 
mand has at least one field. The field can be either 
a variable field or a constant field. Variable fields 
have a first variable for specifying a table and a 

20 second variable for specifying a position within the 
table where variable data is located. The variable 
document command can be any command that 
affects the formatting of a document. Besides in- 
clude text and include image, other possible vari- 

25 able document commands could be conditional text 
command (if/then/eise), skip lines command, 
change font command, etc. 

This invention makes use of the constant and 
variable fields in combination with (actually embed- 

30 ded inside) variable document commands to pro- 
vide the ability to do MCD-type logic within a shell 
document. 

One object of the present invention is to great- 
ly simplify the process of creating and maintaining 
35 complex reports and documents. 

A second object of the present invention is to 
provide the capability to expand the concept of 
variable document commands to other fixed docu- 
ment commands. 
40 A further object of the present invention is to 
provide a system wherein variable or constant 
fields may be embedded into variable text docu- 
ment commands, such that the variable fields of 
the variable document commands may be from a 

45 data file. 

A further object of the present invention is to 
provide a system wherein variable document com- 
mand fields may be modified by changing the data 
file rather than the variable document command. 

so These and further objects of the present inven- 
tion will become apparent from the following de- 
scription of the preferred embodiments when read 
in conjunction with the attached drawings. 

Fig. 1 is a conceptual drawing of a form 
letter suitable for mass mailings. 
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Fig. 2 is a conceptual diagram for the vari- 
able text to be inserted into the form letter of Fig. 
1. 

Fig. 3 is a table of sample data for insertion 
into the form letter of Fig. 1 'arranged as per the 
prior art. 

Fig. 4 is a shell document prepared in accor- 
dance with the prior art to produce the form letter 
of Fig. 1 . 

Fig. 5 is a table containing similar data as 
found in the table of Fig. 3 constructed in accor- 
dance with the present invention. 

Fig. 6 is a shell document prepared in accor- 
dance with the present invention to produce the 
form letter of Fig. 1. 

Fig. 7 is a conceptual flowchart for operation 
of the present invention. 

The preferred mode of the present invention is 
described as incorporated in the IBM Application 
System/4Q0TM. However, those of skill in the art will 
readily appreciate that the present invention may 
be implemented with other systems from the de- 
scription provided herein. 

Fig. 1 is a conceptual view of a form letter 10. 
Such form letters are typically used for mass mail- 
ings for advertising and similar purposes. Form 
letter 10 has a printed letterhead 12 having the 
name and address of the sender along with other 
optional information. Letterhead 12 may be em- 
bossed using standard prior art techniques. 

Inside address 14 contains the name and ad- 
dress of the recipient of the letter. For most mass 
mailings, each copy of form letter 10 will have a 
different recipient and hence a different inside ad- 
dress 14. The information for inside address 14 
may be built into a data file wherein each record 
contains the name and address of a different re- 
cipient. As such, this data file is simply a mailing 
list. 

The introductory line contains the greeting 
"Dear" 16 which is common to all copies of form 
letter 10. Field 18 is wherein the name of the 
recipient is inserted. This is conceivably the first 
entry of each record of the mailing list data file. 

Standard text 20 is also common to all copies 
of form letter 1 0. It may be a single word or two or 
as much as several pages. It is shown here sche- 
matically as a representation of its location. 

Variable text 22 is different for different copies 
of form letter 10. In the most general case, variable 
text 22 for any copy of form letter 10 may consist 
of one or more modules of text which are arranged 
in a particular way to correspond to one or more 
variables associated with the prospective recipient 
of the letter. These variables may be unique (e.g., 
social security number) or may be relatively com- 
mon (e.g., age or sex). The variables may be a 
direct portion of the mailing list (e.g., resident state) 



or may be indirect (e.g., annual income). Variable 
text 22 may vary from a single word to multiple 
pages of text. 

Standard text 24 is similar to standard text 20. 

5 It is the same for all copies of form letter 10. The 
closing, "Sincerely" 26. Is common to all copies of 
form letter 10. It is in that regard the same as 
standard text 20 and standard text 24. Signature 28 
may be unique to one or a class of copies of form 

w letter 10. 

Fig. 2 is an example of variable text prepared 
for insertion into form letter 10. In the instant exam- 
ple, form letter 10 is in response to requests for 
information regarding insurance coverage. The 

15 sender of form letter 10 has information concerning 
four basic types of insurance coverage (i.e., home, 
life, auto and medical). However, because insur-. 
ance law varies from state to state, the relevant 
information concerning each type of insurance cov- 

20 erage can vary depending upon the state of resi- 
dence of the recipient of the information, Therefore, 
the variable text portions are arranged according to 
Minnesota, MN 30; Wisconsin, Wl 40; and Iowa, IA 
50. For clarity only three states are shown. 

25 Home 32 is the variable text which describes 
the home insurance coverage according to Min- 
nesota law. Home 32 may contain a small amount 
of text or may be several pages in length. Similarly, 
home 42 describes the home insurance coverage 

30 according to Wisconsin law. Home 52 describes 
the home insurance coverage according to Iowa 
law. 

Life 34 is that text which describes the life 
insurance coverage according to Minnesota law. 

35 Life 44 and life 54 describe the life insurance 
coverage under Wisconsin and Iowa laws, respec- 
tively. Similarly, auto 36, medical 38, auto 46, 
medical 48, auto 56 and medical 58 describe auto 
and medical insurance coverage under the laws of 

40 Minnesota, Wisconsin, and Iowa, respectively. 

Fig. 3 is table 60 for arranging such data as is 
required to complete form letter 10 according to 
the prior art technique. Table 60 contains column 
62, NAME; column 64, ADDRESS; column 66, 

45 STATE; column 68, HOME; column 70, LIFE; col- 
umn 72, AUTO; and column 74, MEDICAL. Table 
60 has a separate row or record for each recipient. 
Row 76 corresponds to recipient John Smith. The 
corresponding entry in column 64 (i.e., 123 Main...) 

so is the street address of recipient John Smith. The 
corresponding entry in column 66 (i.e., MN) in- 
dicates Minnesota as John Smith's state of resi- 
dence. Column 68 indicates that John Smith 
wants/needs information concerning home insur- 

55 ance coverage. Columns 70 and 72 show that John 
Smith is not to get information regarding life and 
auto insurance coverage. However, column 74 
shows that John Smith should get information re- 
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garding medical insurance coverage. 

Rows 78 and 80 provide the same data for 
prospective recipients Mary Jones and Biil John- 
son, respectively. Additional rows 82 contain data 
regarding other prospective recipients. Such addi- 
tional information is omitted for clarity. 

Fig. 4 shows the form of shell document 100 
created to produce the various copies of form letter 
10, wherein shell document 100 is prepared in 
accordance with the prior art. Inside address 14 is 
prepared using the data field fixed document com- 
mand found in IBM Application System/400TM Of- 
fice Word Processor. Line 102, for example, is 
""&NAME". The nmn indicates a document com- 
mand. The "&" specifies data field. "NAME" is the 
variable. Line 102 says to go to column 62 (entitled 
NAME) of table 60 (see also Fig. 3) and enter the 
contents of one row of column 62 for each suc- 
ceeding copy of form letter 10. Similarly, line 104 
enters the address from column 64, and line 106 
enters the state of residence from column 66. 

Data field fixed document command 108 (i.e., 
•&NAME) inserts the name in the greeting. Stan- 
dard text 20. standard text 24, closing 26 and 
signature 28 are as previously described. 

Variable text 22 is implemented as a pseudo- 
program which must be written by the operator. As 
can easily be seen from Fig. 4, it is variable text 22 
which involves the major complexity of shell docu- 
ment 100. The pseudo-program is performed seri- 
ally as with ordinary software. 

The pseudo-program begins with fixed docu- 
ment command "begin conditional text" (i.e., 
'BCT). This is a branch instruction. If the condition 
in the parenthesis is met. the next sequential step 
is executed. If the condition is not met, control is 
transferred to the next "end conditional text" (i.e., 
*ECT) fixed document command. The only other 
fixed document command needed for variable text 
22 is "include text" (i.e., "INC). This command 
causes the text specified by the variable in the 
parenthesis to be inserted. 

Line 112 determines whether the state of resi- 
dence of the person named at line 102 is Min- 
nesota. If no, control reverts to the next in line 
*ECT which is found at line 122. If the state of 
residence is Minnesota, control sequences to line 
114. Referring also to Fig. 3. it can be seen that 
the first copy of form letter 10 will be sent to John 
Smith (see row 76) who is a resident of Minnesota. 
Therefore, lines 114, 116, 118 and 120 will be 
executed for John Smith, but not Mary Jones or 
Bill Johnson. 

Execution of line 114 determines whether col- 
umn 68 contains n Y" showing that information re- 
garding home insurance coverage is to be sent. If 
not, control reverts to the *ECT at the end of line 
114 and then immediately to line 116. For John 



Smith, column 68 contains "Y". The next fixed 
document command *INC (MN.TEXT.1) then goes 
to MN 30 and inserts the text of HOME 32 (see 
also Fig. 2). Control next proceeds to line 1 16. 
5 The fixed document command of lines 116 and 
118 determine whether text should be inserted 
regarding life and auto insurance coverage. For 
John Smith (i.e., row 76), no such text is required. 
However, line 120 will insert MEDICAL 38 because 
io column 74, row 76 contains "Y". 

The pseudo-program steps for each of the oth- 
er states are represented by lines 124, 126, 128 
and 130. The detail has been omitted for clarity. 
However, it can be easily seen that for four types 
is of information, six pseudo-programming lines are 
needed for each state. For the three states of our 
example, this would be 18 total pseudo-program- 
ming lines. For fifty states, this would be 300 
pseudo-programming lines. 
20 It can further be seen from this example that 
the addition of another type of insurance (e.g., 
RENTER) would require an additional line in the 
pseudo-program for each state. Similarly, the addi- 
tion of a new state will also necessitate large modi- 
25 fication to the pseudo-program. 

Fig. 5 shows table 60 restructured as table 140 
in accordance with the present invention. Table 140 
contains column 62, 64, and 66 which are identical 
to those columns as found in table 60. Columns 68, 
30 70, 72 and 74 of table 60 are replaced with column 
142, PAGES, of table 140. Notice that column 142 
contains the same information as columns 68. 70, 
72 and 74 wherein entry 1 44 corresponds with row 
76, entry 146 corresponds with row 78, and entry 
35 148 corresponds with row 80. Entry 144 means that 
the copy of form letter 10 sent to John Smith (he., 
row 76) should contain page 1 (i.e.. information 
regarding home insurance coverage) and page 4 
(i.e., information regarding medical insurance cov- 
40 erage). Similarly, entry 146 indicates information 
regarding all four types, and entry 148 indicates 
information regarding types 2 and 3 only. 

Table 140 also contains additional column 143 
entitled AGENT. This column points to the image 
45 of a signature for each agent within each state. 
Therefore, MN AGENT 143 represents the signa- 
ture of the agent for Minnesota. Similarly, IA 
AGENT 145 and Wl AGENT 147 represent the 
signatures of the agents for Iowa and Wisconsin, 

50 respectively. 

Fig. 6 is a diagram of shell document 150 
created in accordance with the present invention. 
All elements of Fig. 6 are as previously described 
except the pseudo-program which produces vari- 

55 able text 22 and the signature block 157. The 
pseudo-program has been replaced by a single 
variable document command (i.e., 1NCTXT). No 
conditional fixed document command (i.e.. "BCT) is 
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needed because it is assumed that some text will 
be added for each copy of form letter 10. Further- 
more, the 'INCTXT variable document command 
may have variable fields. 

In the instant example, line 152 indicates where 6 
the specified text will be inserted. The first field 
(i.e., variable field 154, &STATE) says that the text 
to be inserted is all within the state category (see 
Fig. 5) defined by column 66 of table 140 at the 
row of the prospective recipient. The value from 10 
column 66 is the name of the document that con- 
tains the standard paragraphs (see Fig. 2). Contrast 
this with line 114 of Fig. 4 in which the first 
parameter 113 of the "INC fixed document com- 
mand is hard-coded to "MN". is 

Referring again to Fig. 6, field 156 is hard- 
coded to "STDPARAS", which is the name of a 
folder that contains one document for each state. 
However, field 158 is specified by variable field 
&PAGES. This data field causes access to column 20 
142 of table 140 for the row of the prospective 
recipient. In this way, each of the pieces of text to 
be added is specified by table 140, not by shell 
document 150. Addition of more states or more 
types of insurance coverage will not cause any 25 
change to shell document 150. Table 140 must 
change, of course, but modification to table 60 was 
required using the prior art technique as well. 

The remaining change to shell document 150 
according to the present invention is in the signa- 30 
ture. Referring again to Fig, 4, the prior art tech- 
nique was to supply signature 28 by actually sign- 
ing each copy or by printing or stamping the signa- 
ture. The signature block of form letter 150 is 
variable and Is specified by table 140 (see Figs. 5 35 
and 6). 

Form letter 150 contains the variable document 
command 157, •INCIMG. This command causes a 
variable image (in this case a signature) to be 
specified by variable field 155 (&AGENT). In opera- 40 
tion, table 140 column 141 is consulted according 
to the row of the specific copy being prepared, and 
the corresponding signature is inserted as specified 
by column 141. 

Fig. 7 is a flowchart for software modification 45 
required to practice the present invention. The pro- 
gramming stream is entered at 200. Element 202 
scans the next line of shell document 150 for a 
document command. These are signified by a 
leading asterisk (i.e., """). If none is found, control so 
returns to the previous control stream at 214. 

If a document command is found, the fields are 
searched for a variable field at element 206. In the 
preferred embodiment, a variable field is indicated 
by an ampersand within parenthesis, such as line 55 
152 of Fig. 6. Note that line 102 of Fig. 6 does not 
contain a variable field because the ampersand is 
not within parenthesis. If a variable field is found at 



element 208, the document command is a variable 
document command, and element 210 accesses 
the data source to acquire the exact value and 
inserts it into the variable field. If element 208 does 
not find a variable field, the command is a fixed 
document command containing only hard-coded 
fields, and element 210 is skipped. Element 212 
processes the document command. 



Claims 

1. A method of creating a plurality of docu- 
ments, comprising the steps of: 

a. defining a shell document having common 
text and a variable document command, said vari- 
able document command having a variable field; 

b. executing said variable document com- 
mand; 

c. merging into said shell document variable 
data as indicated by said-executing step to create 
one of said plurality of documents; and, 

d. repeating said executing and said merging 
steps to create said plurality of documents. 

2. A method of creating a plurality of docu- 
ments according to claim 1 wherein said variable 
document command further comprises a constant 
field. 

3. A method of creating a plurality of docu- 
ments according to claim 1 wherein said variable 
field further comprises a first variable for specifying 
a table and a second variable for specifying a 
position within said table where variable data is 
located. 

4. A method of creating a plurality of docu- 
ments according to claim 1 wherein said variable 
document command further comprises an include 
text command. 

5. A method of creating a plurality Of docu- 
ments according to claim 1 wherein said variable 
document command further comprises an include 
image command. 

6. A method of creating a plurality of docu- 
ments according to claim 1 wherein said shell 
document further comprises a fixed document 
command. 

7. A method of composing a plurality of docu- 
ments comprising the steps of: 

a. defining a shell document having such 
text as is common to all of said plurality of docu- 
ments and having a variable field for the insertion 
of variable text in each of said plurality of docu- 
ments wherein said variable field contains a first 
variable specifying a table and a second variable 
specifying a position within said table whereby said 
variable text may be located; 

b. drafting said variable text to be inserted; 

c. building said table containing locations of 
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said variable text; and, 

d. forming a plurality of copies of said shell 
document wherein said variable text is accessed 
by said locations from said table and each of said 
copies of said shell document contains variable text 5 
corresponding to said first and second variables. 

8. A data processing system for composing a 
plurality of form documents having variable text 
comprising: 

a. a shell document common to each of said 10 
plurality of form documents having a command for 

the insertion of said variable text wherein said 
command contains a first variable specifying a ta- 
ble and a second variable specifying a position 
within said table whereby said variable text may be 75 
located; 

b. means for storing said variable text; 

c. means responsively coupled to said shell 
document and said containing means for storing 

said table; and, 20 

d. means responsively coupled to said shell 
document, said storing means, and said storing 
means for printing said plurality of form docu- 
ments. 

9. A data processing system according to 25 
claim 8 wherein said shell document further com- 
prises an include image command. 
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© An improved technique for inserting variable text 
or images into shell documents (150) to produce 
complex reports and form letters. This technique 
greatly simplifies the control structure used to insert 
the variable data and makes the maintenance and 
updating of shell documents much easier. To ac- 
complish this, shell documents have common text 
(20, 24) and at least one variable document com- 
mand (152). Variable document commands are per- 
mitted to have variable fields (154, 156, 158). In this 
way, variable text or images may be inserted based 
upon reference to variables stored in variable fields 
without the need to use conditional instructions in 
the shell document. 
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•BCT(STATE EQ tJOT) / 
•BCT(HOME EQ IT) •INC(MN.TEXT,1) *ECT 
-*8CT(l_LFE EO *V) •INC(K4N,TEXTJ) »ECT 

••eoT(Airro eq nr) «inc(mn.textj) «ect 

• *BCT(MEOXCAL EQ *T) «INC(MN.TEXT.4) -ECT 
••EOT 

• "SCT (STATE EQ W) 

-aCT(HOME EQ *V) •INC(WI.TEXT.1) -ECT 
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